home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / timevent / _winfile / ndate104 / readme.txt < prev    next >
Encoding:
Text File  |  1995-07-19  |  6.4 KB  |  193 lines
  1.  
  2.                 netdate v. 1.04 for Windows 3.1
  3.  
  4.         Copyright (c) 1995, Gregorian Programmers Guild
  5.  
  6.                        ***************
  7.  
  8. Description
  9. -----------
  10.  
  11.    This is netdate v. 1.04.  I wrote netdate to synchronise my 
  12. desktop PC's clock with my Unix server.  The program requires 
  13. that you give it a host which is providing the time service on 
  14. Port 37 (most, if not all unix boxes).  Getting time from a
  15. unix box you know is using NTP will give you the most accurate
  16. time on your desktop PC.  This program seems to be accurate to
  17. within about +/- 1 sec.
  18.  
  19.    You must also specify your local timezone.  Basically there 
  20. are two methods for specifying the Time Zone.  You can either 
  21. setup a TZ environment variable in DOS (the hard way) or specify 
  22. a city from the time zone drop down list box.  I've also provided 
  23. a method to adjust the time ahead one half hour for those of you 
  24. living in Newfoundland, Bombay, Calcutta, Delhi, Rangoon, ...
  25.  
  26.    See below for a description of other options.
  27.  
  28.    Refer to the file rfc868.txt for a description of the time
  29. service on port 37.
  30.  
  31. Installation
  32. ------------
  33.  
  34.   - Unzip the archive in a temporary directory.
  35.   - Copy the files netdate.exe and netdate.hlp somewhere convenient 
  36.     (eg. c:\winsock).
  37.   - Check to see whether the file ctl3dv2.dll exists
  38.     in your Windows System directory, if not, do the
  39.     following (assuming your system directory is as
  40.     below),
  41.  
  42.        1) copy ctl3dv2.zip c:\windows\system
  43.        2) cd \windows\system
  44.        3) unzip ctl3dv2.zip
  45.        4) del ctl3dv2.zip
  46.  
  47.     MAKE sure the file ctl3dv2.dll is NOT in the same
  48.     directory as the executable (ie., netdate.exe)!
  49.  
  50.   - add a program manager item
  51.   - run the program
  52.  
  53. Setting up netdate
  54. ------------------
  55.  
  56. This is pretty trivial.  Specify a host from which you
  57. would like to get time.  If you don't know of any try
  58. tick.usno.navy.mil or tock.usno.navy.mil.  You'll also
  59. have to specify your local timezone.  As mentionned
  60. above there are two ways to do this.
  61.  
  62. 1) Select Time zone from the Drop down List box.  These
  63.    are arranged according to city and I've tried to include
  64.    as many as possible.  There are also 25 timezones at
  65.    the end of the list listed as GMT[+-]nn.  If you are
  66.    west of GMT (Greenwich Mean Time) you'd might select
  67.    GMT+05 (this would be Eastern Standard Time).
  68.    
  69. 2) TZ Environment variable
  70.  
  71.    At the DOS prompt (before starting windows) do
  72.  
  73.    set TZ=EST5EDT
  74.  
  75. ideally you'll want to put that line in your autoexec.bat
  76. file.  Of course if you live in Los Angeles you'll use
  77. PST8PDT instead, but you all knew that.  If you live
  78. elsewhere in the world you'll have to find out what the
  79. TZ code is for your area.
  80.  
  81. Other Options
  82. -------------
  83.  
  84. * Use daylight savings
  85.  If you live in an area where daylight savings time does
  86.  not apply click this button off.  This effectively subtracts 
  87.  3600 seconds from the time returned by the host.
  88.  
  89. * Use TZ Env Var
  90.  If this button is greyed you do not have a TZ environment 
  91.  variable set in DOS.  Select a time zone from the Local TZ 
  92.  drop down list.  Otherwise, click it on to use the TZ
  93.  environment variable, or off to select a TZ from the list.
  94.  
  95. * Add 30 minutes
  96.  If you live in Newfoundland click on Add 30 minutes to
  97.  adjust the time accordingly.
  98.  
  99. * Report Only
  100.  If you just want to see the time from the host without
  101.  actually resetting your system clock click on this
  102.  button.
  103.  
  104. * Auto Close
  105.  If you click on Auto Close the program will automatically
  106.  close 5 seconds after time is recieved from a remote host.
  107.  This gives one enough time to turn this option off.
  108.  
  109. * About
  110.  Click on the About button to get all the gory details,
  111.  including how to snarf a copy of my desktop windows
  112.  program DWM, which is meant to replace that monstrosity
  113.  Program Manager.
  114.  
  115. * Sound
  116.  Set sounds in the control panel Sound applet.  You must
  117. run netdate at least one time to have the appropriate
  118. entry placed in the [sounds] section of win.ini.  There
  119. are now 3 sound events that may be set,
  120.    - connect
  121.    - reset
  122.    - max adjust
  123.  
  124. Advanced Options
  125. ----------------
  126. * Max adjust
  127.  Specify 0 to have no maximum time adjustment.  Otherwise,
  128.  enter an integer between 1 and 65353 representing the
  129.  largest time adjustment.  If the time returned differs
  130.  from the local time by more than this value a message
  131.  box will prompt asking whether you want to override the
  132.  maximum adjustment.
  133.  
  134.  Specify one of prompt, ignore or accept to deal with 
  135.  maximum time adjustments.
  136.   prompt - the user is prompted to deal with the event
  137.   ignore - the time recieved is automatically ignored
  138.   accept - the time recieved is automatically accepted
  139.  
  140. * Logging
  141.  Specify use log to enable logging and Verbose for extra
  142.  information.  You must also specify a logfile.
  143.  
  144.  Normal Logging Record (tab delimited fields)
  145.   host date TZ Net_Time Cur_Time (nTime-cTime) Total_Net_Lag Action
  146.  
  147.  Verbose Logging Record (tab delimited fields)
  148.   host date TZ Net_Time Cur_Time Net_Time_Secs Cur_Time_Secs (nTime-CTime)
  149.     Total_Net_Lag Connect_Net_Lag Action
  150.  
  151.  Action can be one of,
  152.   report - time reported but not changed
  153.   reset  - time reset
  154.   ignore - ignore returned time (max Adjustment event)
  155.   accept - accept returned time (max Adjustment event)
  156.   partial- partial reset (max Adjustment event)
  157.  
  158. * Calibration Attempts
  159.  Each time netdate is run the time is retrieved this number of
  160.  times in an attempt to calibrate the net lag more accurately.
  161.  Note that this does not apply when the time is retrieved with
  162.  the Get Time button.
  163.  
  164. Caveats
  165. -------
  166.  
  167.  You must be running Winsock.
  168.  
  169.  The file gpg.ini is created in your windows directory
  170. the first time you run the program.
  171.  
  172.  Net lag is calculated to be half the difference between the time
  173. at connect and when the time data is recieved.  This is a crude
  174. approximation of the time for the return trip but should suffice
  175. for most users.  Getting the time several times and averaging
  176. successive net lags may be a better overall approach and may be
  177. implemented if deemed necessary.
  178.  
  179. Anti-Caveats
  180. ------------
  181.  
  182.    Netdate is free!  Although I retain copyright and thus the
  183. program is not released into the public-domain, yada-yada-yada.
  184.  
  185. Author
  186. ------
  187.    Steeve McCauley
  188.    steeve@eps.mcgill.ca
  189.  
  190.     ftp://ftp.eps.mcgill.ca/pub/windows/ndate100.zip
  191.    http://www.eps.mcgill.ca/~steeve/
  192.  
  193.